home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / telbbs1a.zip / TELAV1A.DOC < prev    next >
Text File  |  1992-02-09  |  13KB  |  436 lines
  1.  
  2.  
  3.  
  4.  
  5.                       TEL AVIV COMMUNICATIONS [TAC] (tm)
  6.                             Bulletin Board System
  7.                                version (1.a)
  8.  
  9. ______________________________________________________________________________
  10.  
  11.  
  12. COPYRIGHT
  13. ---------
  14. COPYRIGHT 1992 by Paul A. Sparacino. All Rights Reserved.
  15.  
  16. DISCLAIMER
  17. ----------
  18. Users of Tel Aviv Bulletin Board Systems' accept this disclaimer:
  19. Tel Aviv BBS, vers.1.a is supplied as is.
  20. The author assumes no liability for damages, direct or consequential,
  21. which may result from the use of Tel Aviv BBS.
  22.  
  23. FREEWARE
  24. --------
  25. Please feel free to distribute this disk, however; to sell this
  26. material also alter and change .EXE files without the authors
  27. consent is a copyright infringement.
  28.  
  29.  
  30.  
  31. CONTENTS
  32. --------
  33. -1- ................... INTRO
  34. -2- ................... SYSTEM REQUIREMENTS
  35. -3- ................... INSTALLATION
  36. -4- ................... INTERNAL FUNCTIONS
  37. -5- ................... THE WAIT SCREEN
  38. -6- ................... MAIN MENU (Public System)
  39. -7- ................... PRIVATE SYSTEM
  40. -8- ................... ULTRA-PRIVATE SYSTEM
  41. -9- ................... SYSOP MENU
  42. -10-................... WRAPPING IT UP
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                              1. Introduction
  52.                             -----------------
  53.  
  54.  In the last 8 years of my telecommunication endevors, I've tried more
  55.  than a dozen bulletin board systems' to explore and possibly put On-Line.
  56.  With the abundance of bbs's available for the IBM computer, I found many
  57.  to be excellent and very well written from a operators stand point.
  58.  My only beef to all or most of the systems that I've tried was the
  59.  messaging aspects of them! I would read a users message and find myself
  60.  rummaging through the operators 10 gigabyte drive trying to find the
  61.  reply or replies to that particular message. The "THREAD" option was not
  62.  exactly my cup of coffee either. The Threading format always looked
  63.  jumbled and by the time you've entered numerous keystrokes to get to your
  64.  location, the message that you've already read had been forgotten.
  65.  
  66.  My sole purpose for writing this software was to incorporate the
  67.  "on going reply or comment" format, to a users existing message.
  68.  
  69.  This is my first attempt in writing bbs software and being laid off
  70.  for the winter of '90, I found myself with an excruciating amount of
  71.  free time, so I blew the dust off the IBM and started plunking away.
  72.  
  73.  As far as the name Tel Aviv goes...that name always had a ring to it as
  74.  long as i can remember.. (different strokes for different folks..hey).
  75.  
  76.  The system itself is DINKY (compared to the mammoth systems available today),
  77.  but I guess prototypes are to be that way!!
  78.  It does not have file transfers, big door programs or user environments...
  79.  in other words, it won't pick your nose.
  80.  Version (1.B) of TEL AVIV will be available 1-1-93... and that one
  81.  is capable of picking your nose... it's gonna be a biggie folks!!!
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.                            2. System Requirements
  98.                            ----------------------
  99.  
  100.  IBM or compatable, Hayes modem or compatable (1200 BPS ONLY) this version,
  101.  COM PORT (1) only - this version, 1 floppy or hard drive, 256k ram minimum,
  102.  Dos 3.1 or higher. CGA card is nice but not necesary for online trans-
  103.  mission is mono, again this version.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                              3. Installation
  120.                              ---------------
  121.  
  122.  Nothing to it... Just run "INSTALL.EXE" and all the necessary data files
  123.  will be installed to the drive you are currently in. No sub-directories
  124.  or paths to fudge around with.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.                            4. Internal Functions
  141.                            ---------------------
  142.  
  143.  After you run Tel Aviv a few times, you'll get the hinkling why this does
  144.  that or why did that do that. When it comes to the point of I did not
  145.  do that is...  probably you did!
  146.  
  147.  The public message numbering and User Numbering are controlled internally
  148.  and recorded to 2 data files know as:
  149.  MNUM.CNT   for message numbering
  150.  USERS.CNT  for assigning User Accounts
  151.  
  152.  If USERS.CNT becomes corrupted due to media crash the system is through
  153.  unless you catch it in time. Users will be overwritten.
  154.  
  155.  If MNUM.CNT becomes corrupted due to a media crash the message numbering
  156.  will not correspond with the file PMSG.LST which list message headings!
  157.  
  158.  It is always important to back-up your files on a daily basis.
  159.  There are these things called brown-outs and lightning?
  160.  
  161.  File Descriptions:
  162.  ------------------
  163.  STAT.DAT   - Displays Last Caller, Password, Access Level, Time and Date
  164.               user logged off (WAIT SCREEN).
  165.  USERS.DAT  - Input data file of all user accounts (heart of the system)
  166.  SYSMSGS.DAT- Text file of all messages directed to the SYSOP via logoff
  167.               and Applicant and logon complaint.
  168.  TWALL.DAT  - Text file of all input written by users of the Grafitti Wall.
  169.  CHAT.DAT   - Text file of all input written by user and sysop during
  170.               the chat session.
  171.  APPS.DAT   - Text file of all input written by new users before validation
  172.               seeking request for access to the system.
  173.  UDESC.DAT  - Text file of all users descriptions.
  174.  PRIVLOG.DAT- Input data file of all user account of the PRIVATE SYSTEM.
  175.  PRIBBS.MSG - Text file message base for the PRIVATE SYSTEM
  176.  ULTRA.MSG  - Text file message base for the ULTRA-PRIVATE SYSTEM
  177.  ULTRA.DAT  - Input data file of all user account of ULTRA-PRIVATE.
  178.  PMSG.LST   - Text file of public message headings.
  179.  USERS.CNT  - Input (counter) data file which keeps track of next available
  180.               user number.
  181.  CALLER.CNT - Input (counter) data file which keeps track of last caller #.
  182.  MNUM.CNT   - Input (counter) data file which keeps track of next available
  183.               public message. This file works inconjunction with file PMSG.LST
  184.  
  185.  System Generated Files:
  186.  -----------------------
  187.  PRI (#).DAT - Users private file for all their private mail. # = User No.
  188.  PMS (#).DAT - Individual public message. # = Message No.
  189.  UD (#).DAT  - Users individual Users Description file. # = User No.
  190.  
  191.  Sysop Generated files:
  192.  Use your favorite ASCII word processor.
  193.  ---------------------------------------
  194.  NEWUSER.SCR -    \
  195.  MMENU.SCR   -     \
  196.  PMENU.SCR   -      \_ Samples of these files furnished on your disk.
  197.  LOGON.SCR   -      /
  198.  LOGOFF.SCR  -     /
  199.  PMS.SCR     -    /
  200.  TWALL.SCR   -   /
  201.  
  202.  BULL.TXT    - Text file of any information that you wish to present for
  203.                the users of the Public System.
  204.  PRIBULL.TXT - Text file of any information that you wish to present for
  205.                the users of the Private System.
  206.  
  207.  FILE1.TXT - \
  208.  FILE2.TXT -  \     These files are read internally by the command module
  209.  FILE3.TXT -   \ _  the way they are listed here, however, when setting
  210.  FILE4.TXT -   /    up your information files remember to name them as
  211.  FILE5.TXT -  /     "FILE2.TXT" the way it will be listed on your disk.
  212.  FILE6.TXT - /      Example: JOEBLOW.TXT will be named FILE2.TXT on disk.
  213.  
  214.  
  215.  
  216.  ACCESS LEVELS:
  217.  --------------
  218.  Access - 1   GENERAL User  : Does NOT have access to PRIVATE, ULTRA PRIVATE
  219.                               and the SYSOP FUNCTIONS.
  220.  Access - 10  V.I.P   User  : Has access to the PRIVATE SYSTEM, but not the
  221.                               ULTRA-PRIVATE and SYSOP FUNCTIONS.
  222.  Access - 15  ELITE   User  : Has access to all PRIVATE SYSTEMS, except
  223.                               the SYSOP FUNCTION.
  224.  Access - 20  SYSOP         : Can do whatever he likes!
  225.  
  226.  A PERSONAL NOTE: I like to reserve an access level of 15 to only one user,
  227.  (i.e) like for my babe!! There in the ULTRA-PRIVATE system you won't be
  228.  bothered by other users of the system! ;-)
  229.  
  230.  
  231.  USER TIME LIMIT:
  232.  ----------------
  233.  There is NONE.... I forgot to write a sub-routine before I compilied
  234.  the software. OOPS! :-(
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.                            (5) The Wait Screen
  253.                            --------------------
  254.  
  255.  After the system is initiated, you will see a screen with information on
  256.  it, the Wait Screen. The purpose for this screen is to show the status of
  257.  your system after a caller has logged off. To your left you will see info
  258.  regarding:
  259.  LAST CALLER, PASSWORD, ACCESS LEVEL, and DATE & TIME user logged off,
  260.  read via STAT.DAT data file. To your right you will see 2 functions:
  261.  (L) Local Logon         : Self-explanatory and takes phone off hook.
  262.  (T) Terminate Tel Aviv  : Ends program and returns to DOS
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.                           6. Main Menu (PUBLIC)
  282.                           ---------------------
  283.  
  284.  A sample of these functions are supplied on your distribution disk with
  285.  the file called MMENU.SCR. When you change this file to your needs, please
  286.  keep in mind to leave the commands as they are!!!
  287.  
  288.  NOTE: Doors have been added to this version and can be activated with
  289.        a batch file called "DOORS.BAT" Door programs will work if they
  290.        were written to the comports. This is still somewhat in the beta
  291.        testing phase. Please let me know how your door programs work
  292.        on this system!
  293.  
  294.        Two comands for Chat Mode (DURING CHAT MODE ONLY)
  295.        *  = Enter Chat Mode
  296.        // = Exit Chat Mode
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.                            7. Private System
  316.                            -----------------
  317.  
  318.  The Private System is basically a small message base which is accessed to a
  319.  user who is assigned an access level of 10 or higher. It incorporates
  320.  one message base and can be delete when the message base gets to large.
  321.  Messages in this mode will also be formated to an "on going comment or reply"
  322.  The user will also be able to read the Private Bulletins and read the
  323.  Private User Log.
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.                          8. Ultra-Private System
  338.                          -----------------------
  339.  
  340.  The Ultra-Private System is basically the same as the Private System which
  341.  is accessed by a user who is assigned an access level of 15 or higher.
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.                               9. Sysop Menu
  359.                               --------------
  360.  
  361.  (1) Sysop Extended Menu   : Add a User , Delete User Files, Read Sysop
  362.                              Messages and Read New Applications. This Version
  363.                              does not delete a user from "USERS.DAT
  364.                              An ascii word processor should be used.
  365.  (2) Reset Message Counter : Changes the numbering system for public messages.
  366.  (3) Reset User Counter    : Changes the numbering system for User Accounts.
  367.                              Should NEVER have to touch this function!
  368.  (4) Reset Caller Count    : Changes the LAST caller count.
  369.  (5) Reset System Time     :
  370.  (6) Reset System Date     :
  371.  (7) Delete Private Message: /NOT AVAILABLE ON THIS VERSION/
  372.  (8) Delete Public Message : Deletes a Public Message off the PMS Board.
  373.                              One pain in the hiny was, I did not incorporate
  374.                              a routine to delete the corresponding message.
  375.                              off the PMSG.LST .... ASCII W.P. will work!
  376.  (9) View a File           : Can change,delete,create and append any txt file.
  377.  (10) Drop to DOS          : Shells to DOS Environment
  378.  (11) SYSOP SNOOPER        : Read users's Private Messages /NOT ON THIS VERS./
  379.  (A) Print Applications    : Print Applications to a line printe.
  380.  (B) Print User Log        : Print User Log to a line printer.
  381.  (C) Print Sysop Messages  : Print Sysop Messages to a line printer.
  382.  (D) Print Private Log     : Print Private Log (Private System) to line printer.
  383.  (E) Print Daily Log       : Print Daily Log to a line printer.
  384.  (F) Print User Description: Print an Individual Description to a line printer.
  385.  (G) Print User Private Msg: /NOT AVAILABLE ON THIS VERSION/
  386.  (H) Print User Public Msg.: Print a Public Message to a line printer.
  387.  (I) Print Grafitti Board  : Print Grafitti Board to a line printer.
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.                          10. Wrapping it Up
  406.                          ------------------
  407.  
  408.  I know this manual is sketchy.. but that's me. I wrote this software for
  409.  it is a foundation for the new version of Tel Aviv (1.b). How do you know
  410.  if it will work if you never try it... for me this is the first time.
  411.  
  412.  LOOKING AHEAD:
  413.  --------------
  414.  As I gain more knowledge of writing bbs software, Tel Aviv Communications
  415.  will grow and grow and new functions will be added and / or delete from
  416.  this version. I am currently writing the commercial version (1.b) of Tel
  417.  Aviv and yes that will include File Transfers, Door Programs, Questionairres,
  418.  and of course Multi-Line operations.
  419.  
  420.  
  421.  Well, I hope you find some worth to all of this... I did!
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  Tel Aviv Communication (tm)
  429.  Bulletin Board Systems
  430.  (c)1992 Paul A. Sparacino
  431.  
  432.  
  433.  
  434.  
  435.  
  436.